Skip to content

Docs: align pytest.mark.xfail and skip parameter signatures with reality (#10094)#14725

Merged
nicoddemus merged 2 commits into
pytest-dev:mainfrom
Joosboy:docs/10094-xfail-skip-docs
Jul 23, 2026
Merged

Docs: align pytest.mark.xfail and skip parameter signatures with reality (#10094)#14725
nicoddemus merged 2 commits into
pytest-dev:mainfrom
Joosboy:docs/10094-xfail-skip-docs

Conversation

@Joosboy

@Joosboy Joosboy commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Closes #10094.

This PR fixes the documentation signatures and parameter descriptions for pytest.mark.xfail and pytest.mark.skip to accurately reflect the codebase.

  • pytest.mark.skip's reason defaults to "unconditional skip", not None.
  • pytest.mark.xfail's condition defaults to None instead of False.
  • pytest.mark.xfail's raises parameter explicitly allows None.

Comment thread doc/en/reference/reference.rst Outdated
@nicoddemus
nicoddemus force-pushed the docs/10094-xfail-skip-docs branch from b6d5d23 to 0107508 Compare July 23, 2026 09:54
@nicoddemus nicoddemus added the skip news used on prs to opt out of the changelog requirement label Jul 23, 2026
@nicoddemus
nicoddemus enabled auto-merge (squash) July 23, 2026 09:55
@nicoddemus
nicoddemus merged commit a53a4d9 into pytest-dev:main Jul 23, 2026
36 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip news used on prs to opt out of the changelog requirement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Reference documentation, typing annotations and reality for pytest.mark.xfail() don’t match

2 participants